home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 21 / AACD 21.iso / AACD / Sound / DelfinaMPEG / dmdev.readme < prev    next >
Text File  |  2001-04-09  |  4KB  |  113 lines
  1. Short:  Mpeg.device for Delfina DSP
  2. Author: Smack/Infect! (Michael Henke)
  3. Type:   mus/play
  4.  
  5. $VER: delfinampeg.device 1.1 (Sat 07-Apr-2001)
  6.  
  7.  
  8.  #features
  9.    -plays MPEG audio files with almost no CPU load
  10.     (Delfina's DSP56002 does all the decoding and playback)
  11.  
  12.    -standard "mpeg.device" API
  13.     (code based on melodympeg.device by Thorsten Hansen)
  14.  
  15.    -free software
  16.     (full source code included, of course)
  17.  
  18.  
  19.  #requirements
  20.    -CPU 68020+
  21.    -Delfina DSP board
  22.  
  23.  
  24.  #changes since previous release
  25.    -mp3 decoder: fixed a bug which had caused minor distortions
  26.    -mp3 decoder: implemented INTENSITY STEREO decoding (at last)
  27.    -added configuration options (ENV-variable DELFINAMPEG)
  28.  
  29.  
  30.  #how to use it
  31.    Copy delfinampeg.device to your "devs:" drawer and configure an application
  32.    program to make use of it, for instance:
  33.  
  34.    AMPlifier    http://www.katodev.de
  35.        Configuration -> Audio I/O -> MPEG audio player -> Decoder
  36.        MPEG device:    delfinampeg.device
  37.        Unit:           0
  38.        Buffersize:     128 (recommended, use any value you want)
  39.        Blocksize:      16  (recommended, use any value you want)
  40.        set Layer I/II and Layer III to "Hardware" decoding
  41.  
  42.    Frogger      http://frogger.rules.pl
  43.        use the option ADECODER with mode DELFINA
  44.  
  45.    Especially owners of the slower Delfinas (such as Lite) might be interested
  46.    in the new configuration options of delfinampeg.device, which can be used
  47.    to sacrifice some playback quality in order to reduce DSP load. The device
  48.    reads them from the environment variable DELFINAMPEG during OpenDevice().
  49.    The options are:
  50.  
  51.    L2MONO...........mp2 files: decode left channel only
  52.    L2RATE <number>..mp2 files: play at specified rate (given in kHz)
  53.    L3MONO...........mp3 files: decode left channel only
  54.    L3RATE <number>..mp3 files: play at specified rate (given in kHz)
  55.  
  56.    The given playback rate is automatically rounded to the nearest available
  57.    Delfina rate (16, 27, 32, 48 kHz; Delfina 1200/Plus: 12, 24, 36, 48 kHz).
  58.    example:
  59.    > setenv DELFINAMPEG l3rate 32 l2mono
  60.      (play mp3 files at 32 kHz, force mp2 decoding to mono)
  61.    > copy ENV:DELFINAMPEG ENVARC:
  62.      (save settings to disk)
  63.  
  64.  
  65.  #known problems
  66.    -use the latest (beta) delfina.library - the README of DelfMPEG contains
  67.     a list of known bugs in the library.
  68.  
  69.    -the MPEG decoding routines are taken from DelfMPEG, so the same
  70.     restrictions apply here:
  71.      -only MPEG-1 layer II and III audio files are supported.
  72.      -the decoding routines need a lot DSP processing power, especially
  73.       mp3 playback might overburden the slower Delfinas (such as Lite).
  74.       try the config options listed above if you get "stuttering" sound,
  75.       because that can be the result of the DSP decoding data too slowly.
  76.  
  77.    -equalizer and visual effect plugins of AMPlifier are currently not
  78.     supported. this is not a feature of the mpeg.device. AMPlifier needs to
  79.     copy the decoded audio data back from the sound board to main memory,
  80.     which it can only do with the Melody boards but not (yet) with Delfina.
  81.  
  82.  
  83.  #acknowledgements
  84.    delfinampeg.device uses ideas/code from:
  85.    -MPEG Audio Layer II decoder by Fredrik Noring and Tomas Berndtsson
  86.     (an mp2 player for Atari Falcon, DSP56K code)
  87.    -amp11 by Niklas Beisert (clean and fast C++ code)
  88.    -FalcAMP by Denis "STGhost" Huguet and David "Splash" Carrere
  89.     (an mp3 player for Atari Falcon, DSP56K code)
  90.    -reference code by MPEG Software Simulation Group ("the original" C code)
  91.    -melodympeg.device by Thorsten Hansen
  92.  
  93.  
  94.  #author
  95.    mailto: Michael Henke <smack@smack.de>
  96.  
  97.    delfinampeg.device - mpeg.device for Delfina DSP
  98.    Copyright (C) 2000, 2001  Michael Henke
  99.  
  100.    This program is free software; you can redistribute it and/or modify
  101.    it under the terms of the GNU General Public License as published by
  102.    the Free Software Foundation; either version 2 of the License, or
  103.    (at your option) any later version.
  104.  
  105.    This program is distributed in the hope that it will be useful,
  106.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  107.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  108.    GNU General Public License for more details.
  109.  
  110.    You should have received a copy of the GNU General Public License
  111.    along with this program; if not, write to the Free Software
  112.    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  113.